home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / Timing / Cal.lha / cal / Cal.DOC next >
Encoding:
Text File  |  1992-05-29  |  3.4 KB  |  107 lines
  1.  
  2.     Cal
  3.     ~~~
  4.           This  is  my  first  program  which  really  makes  use  of
  5.     Kickstart2.04, as a matter of fact, you NEED Kickstart2.04 to run
  6.     it! (So you better run out and buy it right now..)
  7.  
  8.  
  9.     What is Cal?
  10.     ~~~~~~~~~~~~
  11.        Cal is a kind of diary which helps you to keep  track  of  all
  12.     those things you have to do, like making that dentist appointment
  13.     (sigh!),  pay  your bills etc. etc. It is extremly small (written
  14.     in  assembler)  and  quite  fast  and  easy  to  use.  The   only
  15.     requirement  is  that  you  have  the new Kickstart and two files
  16.     located on your disk. The first file is  of  course  the  program
  17.     'Cal'  and  the  second  is  the  datafile, 'S:Calendar' which is
  18.     a plain textfile which you can create using any editor.
  19.  
  20.     Why Cal?
  21.     ~~~~~~~~
  22.        I've seen a lot of  diary-programs,  some  mouse-driven,  some
  23.     with  their  own appointment-editor etc. etc. Other requires that
  24.     font, or that library. All of them are rather  big.  Cal  uses  a
  25.     plain textfile, (with a very flexible format), is (currently) 712
  26.     bytes  small and removes any old appointments automatically. Even
  27.     if you are a floppy user you can  install  it  in  your  startup-
  28.     sequence  since it works fast and load fast. (Buffered input) You
  29.     could also use it as a 'Today'-program if you run a BBS (but have
  30.     someone else building the Calendar-file for you...).  Output  may
  31.     be redirected anywhere.
  32.  
  33.  
  34.     Cal's syntax is
  35.  
  36.     Cal [-c] [dyy-mm-dd]
  37.  
  38.     Please note the order of the parameters!
  39.  
  40.     [-c]
  41.        Cleanup. Will run Cal as usual, but will remove all old  dates
  42.     and  notes  from  S:Calendar.  All notes which are older than the
  43.     current date will be removed. You need to have your  disk  write-
  44.     enabled.
  45.  
  46.     [dyy-mm-dd]
  47.        Substitute todays date with this date.
  48.  
  49.     Examples (todays date is 92-02-22) :
  50.  
  51.     INPUT : Cal
  52.     OUTPUT: 92-02-22 Well, yet another day... :-)
  53.  
  54.     INPUT : Cal d92-02-19
  55.     OUTPUT: 92-02-19 Don't forget to bring that disk tomorrow.
  56.  
  57.     INPUT : Cal -c
  58.     OUTPUT: 92-02-22 Well, yet another day... :-)
  59.  
  60.     INPUT : Cal d92-02-19
  61.     OUTPUT: (Nothing, this entry has been erased from the file)
  62.  
  63.  
  64.     S:Calendar
  65.     ~~~~~~~~~~
  66.        The format of this file is quite simple. Before  any  of  your
  67.     dates  you  may  place  some text which you want Cal to greet you
  68.     with each time it is run.  If  you  don't  want  any  text  start
  69.     entering  the  dates  directly.  The dates must be located on the
  70.     beginning of a line, and have the  form  yy-mm-dd  (year,  month,
  71.     day). The Calendar-file may contain empty  lines anywhere and the
  72.     dates may be in any order.
  73.  
  74.     Examples :
  75.  
  76.     Hi Niklas!
  77.     Let us see what you have to do today....
  78.  
  79. 92-08-03 Hey! This is my birthdate.
  80. 92-02-19 Don't forget to bring that disk tomorrow.
  81.  
  82.  
  83.     Another example :
  84.  
  85. 92-08-03 Hey! This is my birthdate.
  86. 92-02-22 Finish Cal today.
  87.          Don't forget meeting at 15.00
  88.          Promised go shopping (sigh!!)
  89. 92-08-03 Still is my birthdate, but placed after 92-02-22..
  90.  
  91.     You could also have written :
  92.  
  93. 92-08-03 Hey! This is my birthdate.
  94. 92-02-22 Finish Cal today.
  95. 92-02-22 Don't forget meeting at 15.00
  96. 92-02-22 Promised go shopping (sigh!!)
  97. 92-08-03 Still is my birthdate, but placed after 92-02-22..
  98.  
  99.  
  100.     ACKS
  101.     ~~~~
  102.     Cal is PD, use it as much as you like, anywhere you like.
  103.  
  104.     Niklas Sjöberg, 92-02-22
  105.     2:203/415.3@FidoNet
  106.  
  107.